home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3dm / audio / alZeroFrames.z / alZeroFrames
Encoding:
Text File  |  1998-10-20  |  4.5 KB  |  67 lines
  1.  
  2.  
  3.  
  4. aaaallllZZZZeeeerrrrooooFFFFrrrraaaammmmeeeessss((((3333ddddmmmm))))                                            aaaallllZZZZeeeerrrrooooFFFFrrrraaaammmmeeeessss((((3333ddddmmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      alZeroFrames - write zero-valued sample frames to an audio port
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////aaaauuuuddddiiiioooo....hhhh>>>>
  13.  
  14.      iiiinnnntttt aaaallllZZZZeeeerrrrooooFFFFrrrraaaammmmeeeessss((((ccccoooonnnnsssstttt AAAALLLLppppoooorrrrtttt ppppoooorrrrtttt,,,, ccccoooonnnnsssstttt iiiinnnntttt ffffrrrraaaammmmeeeeccccoooouuuunnnntttt))))
  15.  
  16. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRR
  17.      _p_o_r_t         is the audio output port to which you want to write samples.
  18.                   This is the returned value of an aaaallllOOOOppppeeeennnnPPPPoooorrrrtttt((((3333ddddmmmm)))) call.
  19.  
  20.      _f_r_a_m_e_c_o_u_n_t   is the number of sample frames that you want to write to the
  21.                   audio port.
  22.  
  23. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.      aaaallllZZZZeeeerrrrooooFFFFrrrraaaammmmeeeessss writes a given number of zero-valued sample frames to the
  25.      specified audio port.  aaaallllZZZZeeeerrrrooooFFFFrrrraaaammmmeeeessss blocks until _f_r_a_m_e_c_o_u_n_t sample frames
  26.      have been written to the port.  If you do not wish to block, make sure
  27.      that _f_r_a_m_e_c_o_u_n_t is less than the return value of aaaallllGGGGeeeettttFFFFiiiillllllllaaaabbbblllleeee((((3333ddddmmmm)))).
  28.  
  29.      aaaallllZZZZeeeerrrrooooFFFFrrrraaaammmmeeeessss is a convenience function, equivalent to calling
  30.      aaaallllWWWWrrrriiiitttteeeeFFFFrrrraaaammmmeeeessss((((3333ddddmmmm)))) with a zero-valued buffer of the given size. However,
  31.      aaaallllZZZZeeeerrrrooooFFFFrrrraaaammmmeeeessss is simpler, particularly when _f_r_a_m_e_c_o_u_n_t is large; it avoids
  32.      having to allocate a large buffer or iterate over many writes of a
  33.      smaller buffer. It is also more efficient than the equivalent
  34.      aaaallllWWWWrrrriiiitttteeeeFFFFrrrraaaammmmeeeessss call.
  35.  
  36.      Note that since an audio port contains an internal queue, zero-valued
  37.      frames written to the port will not immediately come out the associated
  38.      audio device or devices. aaaallllGGGGeeeettttFFFFiiiilllllllleeeedddd((((3333ddddmmmm)))) will indicate how many samples
  39.      are currently in this queue. Also, aaaallllGGGGeeeettttFFFFrrrraaaammmmeeeeTTTTiiiimmmmeeee((((3333ddddmmmm)))) and
  40.      aaaallllGGGGeeeettttFFFFrrrraaaammmmeeeeNNNNuuuummmmbbbbeeeerrrr((((3333ddddmmmm)))) provide facilities for precise synchronization of
  41.      audio and other media.
  42.  
  43.      In order to achieve the best possible performance, aaaallllZZZZeeeerrrrooooFFFFrrrraaaammmmeeeessss does not
  44.      attempt to verify that _p_o_r_t or _s_a_m_p_l_e_s are valid. You should make certain
  45.      these values are valid before passing them as arguments to aaaallllZZZZeeeerrrrooooFFFFrrrraaaammmmeeeessss.
  46.  
  47. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  48.      aaaallllZZZZeeeerrrrooooFFFFrrrraaaammmmeeeessss always returns 0.
  49.  
  50. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  51.      alOpenPort(3dm), alGetFillable(3dm), alGetFilled(3dm),
  52.      alSetChannels(3dm), alSetWidth(3dm), alReadFrames(3dm),
  53.      alZeroFrames(3dm), alSetConfig(3dm), alSetQueueSize(3dm),
  54.      alSetSampFmt(3dm), alSetFloatMax(3dm)
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.